run diagnostics

run diagnostics [extended | normal] }

Description

Runs normal or extended diagnostics on the switch or node, and stacking ports.

This command is not supported in stacking mode, but if you issue the show diagnostics command from the master node, it will show the diagnostic results for all the nodes.

Syntax Description

extended Runs an extended diagnostic routine. Takes the ports offline, and performs extensive ASIC and packet loopback tests on all of the ports.
normal Runs a normal diagnostic routine. Takes the ports offline, and performs a simple ASIC and packet loopback test on all of the ports.

Default

N/A.

Usage Guidelines

Use this command to run diagnostics on the switch.

If you run the diagnostic routine on the switch, it reboots and then performs the diagnostic test. During the test, traffic to and from the ports on the switch is temporarily unavailable. When the diagnostic test is complete, the switch reboots and becomes operational again.

After the switch runs the diagnostic routine, test results are saved and messages are logged to the syslog.

To run diagnostics on a switch that is in a SummitStack, first disable stacking on that switch, then restart the switch. Once restarted, log into the switch via its console port, and run diagnostics. The switch will perform the diagnostic tests, and then restart. Once restarted, log into the switch via its console port and enable stacking, then reboot the switch. Once restarted, the switch will rejoin the stack.

Viewing Diagnostics

To view results of the last diagnostics test run, use the following command:

show diagnostics {slot [slot_number]} {boot-time}

If the results indicate that the diagnostic failed on a node, replace the node with another switch of the same type.

If the results indicate that the diagnostic failed on the switch, contact Extreme Networks Technical Support.

The following example runs normal diagnostics on a ExtremeSwitching series switch:

run diagnostics normal

The switch displays a warning similar to the following about the impact of this test. You also have the opportunity to continue or cancel the test:

Running Diagnostics will disrupt network traffic.
Are you sure you want to continue? (y/n)

Enter y to continue and run the diagnostics. Enter n to cancel the operation.

History

This command was first available in ExtremeXOS 10.1.

Platform Availability

This command is available on all Universal platforms.